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0 Word Help 



File Edit Bookmark Options Help 



Contents Search Back Print Index 



Word Help Contents 

To learn how to use Help, press F1. 




i 




Using Word 

Step-by-step instructions to help you complete 
your tasks 



Examples and Demos 

Visual examples and demonstrations to help 
you learn Word 



Reference Information 

Answers to common questions; tips; and guides 
to terminology, commands, and the keyboard 



>-305 




Programming with Microsoft Word 

Complete reference information about the 
WordBasic macro language 

Technical Support 

Available support options so that you can get 
the most from your Microsoft product 
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WordBasic Statements and Functions 

Conventions 

Statements and Functions by Category 
Statements and Functions Index 



More WordBasic Information 

What's New in WordBasic 
Creating Dynamic Dialog Boxes 
Using OLE Automation with Word 
Key Examples in WordBasic Help 
Operators and Predefined Bookmarks 
Error Messages 



Toolbar Button Images and Numbers 
Converting Word Version 2.x Macros 
The Microsoft Word Developer's Kit 
Microsoft Solution Providers 
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When you run a macro and an error occurs, you can get more information by pressing F1 or choosing the Help button in thep 
error message box. The following lists, the first for WordBasic error messages and the second for Word error messages, 
includes numbers you can use when trapping errors. For more information on error trapping, see On Error statement. 

WordBasic Error Messages 



Error# 


Message 


5 


Illegal function call 


6 


Overflow 


7 


Out of memory 


9 


Subscript out of range 


11 


Division by zero 


14 


Out of strinq space 


22 


Invalid arrav dimension 


24 


Bad parameter 


25 


Out of memorv (stack space) 


26 


Dialoq needs End Dialoq or a push button 


28 


Directory already exists 


39 


CASE ELSE expected 


51 


Internal error 


52 


Bad file name or number 


53 


File not found 


54 


Bad file mode 


55 


File alreadv open 


57 


Device I/O error 


62 


Input past end of file 


64 


Bad file name 


67 


Too manv files 


74 


Rename across disks 


75 


Path/File access error 


76 


Path not found 
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Syntax error 
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File Edit Bookmark Options Help 



Contents Search Back Print Index 



WordBasic error 25 

Out of memory (stack space) 



There is not enough memory to perform the operation. See Freeing up memory . 
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Freeing up memory 



Use as many of the following procedures as practical to free up 
memory. After each step below, try again to complete the task. 



To free up memory 

Do one or more of the following: 

• From the File menu, choose Save All. 

• Quit any other applications you are running. f 

• Clo se all windows and panes except for the active win dow. 
•Ifyf 

Rul 

Vie> 

The 
•Hid 
•Qui 
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Active window 

The window in which you are working. The active window contains 
the insertion point or a selection of text or graphics. The title bar in 
the active window is highlighted. 
uuuiu, a i m m e n l e aiau u. 
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• Quit all open applications, and then restart the computer. If 
applicable, disconnect network connections, and quit 
terminate-and-stay-resident applications (TSRs) and any other 
utilities you usually run. 



FIG. 3D 

PRIOR ART 



B-BASED INSTRUCTION 
IK HENNUM 
5/728,073 



X 



mm 



m 

III | 
|h I 



CD 



linn 

HUM 



o 
-o 
c: 



.92 

CO 

o 

ft 



a: 



0| 



il 



CD 

E 

Z3 
O 

o 
Q 
i 

■a 

jo 



CD 
CO 

c, 



0=: 
o 

CO 

§ 



92 
LU| 



if 

150 



co 
E 
o 

cr 

CD 



CD 

E 



o 



-Q 

"5 
CD 



<d 
E 



CD 



i — 

o 



<D 

E 



co 

o5 

CD 



CO 
Q 
CD 



O 



^3 



X 

□ 



□ 



(B 



Oi 



o 

CO 

CQI 



o 
,o, 



Oi 



CD 
O 

c 

CO 

O 

o 

"o 

tt= 
o 

■a 

CD 



2> •§ 



a> 
o 
c 
to 
O 



a. 
•a 



05 

o 

CO 



CD 

_o 
"o 

I 

_CD 
-O 
ZJ 
O 

•a 

cf 
o 

"O 

CD 

cz 



CO 
CO 

"E -3 

■c: CO 
Q- o5 
*0 CD 

§£ 
2 <= 
o> ° 
■gCQ 

CO c 

— .S2 



CD 

1=1 

i 21 

CD co cx 

CD 

O D_ CD 
CO Q_ C_> 
-Q CO CZ 
-C ^- CO 

CO c o 

CZ CD — 

3 g ° 

*o i- * - 

— CD ZJ 

1-1^ 

« °- o 

CO <D **— 

:|si 

2> E g* 

§..S2 CO 

CZ CO 
O •§ S 

Z a w 



o 

6 



J ■ ► 



8 

' CD 
O £ c 



a> q5 

i §> 



£ o ^ 

II I 

I El I 

I si 1 2 



o 2 -s 



u> o c 



a- co qj 
-o a. a. <o 

I? 1 



c£00 



-° ^ 
E cp 

00 



« CO n 

% £ £ 
=3 OIO 

0001 



> 
o 



X 



a: 



o 

LU 



o 

o 



o 

CD 
CO 



CD 
CD 
CO 

a. 



WEB-MfcD INSTRUCTION 
ERIK H^PUM 
09/728,073 



@> WordBasic Help 

File Edit Bookmark Options Help 



□US 



Contents Search Back Print 
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Programming with 
Microsoft Word 

□ Word Help Contents 



WordBasic Statements and Functions 

Conventions 

Statements and Functions by Category 
Statements and Functions Index 
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More WordBasic Information 

What's New in WordBasic 
Creating Dynamic Dialog Boxes 
Using OLE Automation with Word 
Key Examples in WordBasic Help 
Operators and Predefined Bookmarks 
Error Messages 

Toolbar Button Images and Numbers 
Converting Word Version 2.x Macros 
The Microsoft Word Developer's Kit 
Microsoft Solution Providers 
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AddAddln, AddAddln() 

□ Example . 

AddAddln Addln$[, Load] 
Mdkdd\r\{Addln$ [, Load]) 

, The AddAddln statement adds a template or Word add-in library (WLL) to the list of global templates and add-ins in the 
Templates And Add-ins dialog box (Templates command, File menu). 

Argument Explanantion 

Addln$ The path and filename of the template or WLL 

Load Specifies whether to load the template or add-in after adding it to the list: 



The AddAddln() function behaves the same as the statement and also returns a value corresponding to the position of the 
global template or add-in in the list, where 1 is the first template or add-in, 2 is the second, and so on. This value may be used 
with other add-in statements and functions. 

You can use functions defined in a loaded WLL in a macro. Functions that take no arguments may be used just like 
WordBasic statements; you can return the names of these functions using CountMacros() and MacroNames$(). Functions 
in the WLL that take arguments must be declared using the Declare statement. 

For more information on loading global templates and add-ins, see Chapter 31, "Customizing and Optimizing Word," in the 
Microsoft Word User's Guide. For more information on using functions in WLLs, see Chapter 9, "More WordBasic 
Techniques," in the Microsoft Word Developed Kit. 



See Also 

Documents, Templates, and Addlns Statements and Functions 

AddlnStateQ 

ClearAddlns 

CountAddlnsQ 

CountMacrosQ 

DeleteAddln 

GetAddlnlDQ 

GetAddlnNameSQ 

MacroName$() 



0 (zero) Does not load the template or add-in 

1 or omitted Loads the template or add-in 




PRIOR ART 



webj«|ed instruction 
erikVHnum 

09/728!073 
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Close Copy Print 



GetCurValues Example 



This example uses GetCurValues to retrieve the date the active document was created from the Document 
Statistics dialog box (Summary Info command, File menu). The instructions then use date functions to calculate the 
number of days since the document was created and display a message box according to the result. 

Dim dig As DocumentStatistics 
GetCurValues dig 
docdate$ = dig. Created 
age = Now() - DateValue(docdate$) 
age = Int(age) 
Select Case age 
Case 0 

MsgBox "This document is less than a day old." 
Case Is > 0 

MsgBox "This document was created" + Str$(age) + "day(s) ago." 
Case Else 

MsgBox "Check your computer's date and time." 
End Select 

For an example that uses GetCurValues and shows how to toggle any check box, see AbsQ Example. 
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File Edit Bookmark Options Help 



Help Topics | Back 
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Run 



The MAIN( ) FUNCTION 



button2m.4gl: 



MAIN 

VARIABLE exampleWindow exampleWin 
CALL ixSQLConnect : :get ImplicitConnection( ) 
•Let exampleWindow = NEW exampleWin () 
CALL exampleWindow. open ( ) 

RETURN 

END MAIN 



. connect ( " Sports " ) 
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LET 



The LET statement assigns a value or an object reference to a variable, or else assigns a 
value to every member of a record or of an object. 

Case I: single-variable 
LET — 



Variable 



Expression List - 



0 



- blob - 
foreign • 



-mil- 
foreign- 



iListKy] 



946 



Case II: multiple-variable 

LET v — record — ^- — 

^-J Object Expression l~^ = ^ = 



Multiple-Value 
Expression 



Variable 



- class - 
record 



i 



variable- 



Object Expression 



V/IV-array/'-^ Integer Expression )- 



Element Description 

array The name of an ARRAY variable. 

blob The name of a BYTE or TEXT variable. 

class The class of the object whose member variable is assigned values. 

foreign The name of a FOREIGN variable. 

record The name of a RECORD variable. If no member (or if .*) is specified, 

then all its member variables receive values. 

variable The name of a variable of a simple data type. 
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Expressions of NewEra: Object Expressions 



An object expression is a specification that evaluates to an object reference. You can 
reference objects through variables, function calls, casts, or constructors. 



Object Expression 



-Zl^SELF- 



Reference 
^ Variable 



Function Call . 



>CAST 



^-COPY- 
-NEW 



Object 
Expression 



■class-{ 
-NULL 



Argument List 



2 



AS 



actual , 
class 



actual 
class 



Reference 



\-classrJ 



record 



1 



■ variable- 



Object Expression 
(not SELF nor NULL) 



^VW-arravf^- Integer Expression^ - ] 



V.] 



Element Description 

array Name of the actual class of the object. If object 
class expression includes a call to a constructor, an object of 

actual class is constructed. 
array Name of an ARRAY variable that contains a reference to 

the object. 

class Name of a class previously declared in the same 
module, and also the stated class of the object 
reference. 



Restrictions 

Must derive from 
stated class of 
object reference. 
Element must 
have a class for 
its data type. 
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[?]NewEra by Example 



Features of the Button2 Example 



Overview of the Buttons2 Example 

Graphical Object Summary 

Event Handler Summary 

Important Event Handlers 
QexampleWin :: start() 
EqueryBT:: activate( ) 
HfindBT :: activate( ) 
EnextBT::activate() 
EpreviousBT::activate() 
EinsertBT::activate() 
EdeleteBT::activate() 

□ applyBT::activate() 

□ clearBT:: activate() 
EexitBT :: activated 
EentryWIN :: pre-header extension 
E entryWIN :: class extepsiaa 
EentryWIN :: pre-body 

Enhancements and Var 



0 NewErk Language Reference 



File Edit] Bookmark Options Help 

Contents | index | Back [Overview | Topics 



glossary j 



LET 



The LET statement assigns a value or an object reference to a variable, 
or else assigns a value to every member of a record or of an object. 

Case I: single-variable 
LET 




■ foreign 



mil- 
foreign - 



Case II: multiple-variable 



- record 



Object Expression 



— Multiple-Value 
Expression 



Variable 



c 



• class • 
record 



M Object Expression I- - 



[^Glossary Terms 



NewEra Glossary Gajr 



abstract class 
accelerator key 
access control 
accessible function 
activation 
active set 
actual argument 
actual class 
aggregate function 
alias 

anchor 

ANSI-complian t 
appearance 



2 



T 



[?] Informix-NewEra Glossary 



Contents 



Index 



Back 



Options 



□Big 



abstract class 



A class that cannot be used directly to create objects, but 
that serves as a base class from which to derive other 
classes. See also constructor function. 



950 



952 



FIG. 91 



WEB-MfcED INSTRUCTION 

erikI^Pmum 

09/728,073 



m 
a 



E 

LU 

CD 



CD 

o 

:i 

_co 
o 

■2. 



CD 

E 

o 
o 
Ol 



xl 

.CD 



O 
CD 

"o 

_d 
O 

CD 
CD 



CT5 

CD 
O 

o 



LUl 

CD 



G»3 



1 



o 
O 



LO 



X 



□ 



□ 



05 

E 

CNJ 



CNJ 

CO 

rz 
o 



CO 

o. 
E 

CD 
X 
JD 

O 
CO 
CD 

LU 

CD 

□ 



A 
52 



3S I 
0) CM 
i— I CO 

Oi c 

e o 



CO 

-p 
u 
o 
a, 

CO 



o 
a> 
c 
c: 
o 
o 

A 
V 

c 
o 

•H 
-P 
CJ 

a) 
c 
c 
o 
u 
-p 



(0 
X 

cu 





x: 






on 












C 






C 


Xi 




o 


On 




o 






x 




cu 






-p 




CM 






C3 


-p 




O 


o 


w 


-P 


c 


Eh 


-P 




CO 




co 


>t 


XI 




CO 




w 


W 


w 


Q 


Q 


Q 


ZD 




ZD 




t-q 


t-H 


CJ 




CJ 


2: 


£5 




»— i 


n 


1— 1 



o 

•H 
CD 



-P 
-P 

Xt 
V 

a> 

-P 
CO 
-P 

o 
c 

04 CO 

e 

(0 

X X 

a> a) 
^ <u 

PQ C 

§3 



A 
V 

c 

CU 



Oi 

g 

c0 

x 

CU CU 

S s 

-P pq 
cu S 

II 

-p > 
u o 

CU T3 
C C 
C -H 
O & 

o cu 
o a* 

CO g 

x co 



A 
V 

c 

(U 

a. 
o 

i 

T3 
C 
-H 
& 

a) 
i— i 

Oi 



X 

co 



Pi 

Eh 

w 

PS 



Q 



_CD 

E 

CD 
X 
LU 

CO 



5 

CD 



w. 
oa 



ASED INSTRUCTION 
ENNUM 
,073 



Si 

SrSi 



W 

y 



x 



□ 



CO 

O 

"O 

CD 
O 

cz 

CO 



5 

CM 

cz 



o 

CO 
1 — 
CD 



CO 

□_ 



o 

"O 

cz 



CO 
UJ 

CD 



CD 
XI 

O 



CD 



1 



-DQ- 
□□□ 

N Q 

□an 



1 

a 



► 

CD 
Q_ 
=J 
CO 



Z9 



□fl 



o CO 



.CO 



H3 



_J .2 



>< \zz ft Ct < 



5* as 
o 

-Q O 



| §- 

§ sa 

O iS 

.a a) 



CD 
O 

.£2 c 

X3 CD 



CO 
CD 



CO 
CM 



o 
O 

"O 



o o o 



CO 
O £ 



^! ^ ~ ~ ^ ^ J .5>Q.Q. 



IS 



5 
o 

c 



CD 



LU 
CD 

a 

CD 
O 

cz 

CO 



CNJ 

cz 
o 



a 



a. 



CO 

E 

i— 
CD 

E 
o 

CO 
=3 

o 



A 




A 


CD 




CD 


E 




E 


CO 




CO 






c 


V 




V 



A 




A 






CNJ 


CO 




CO 


CO 




CO 


CD 




CD 


t — 




h_ 


"O 




"O 


-a 




-a 


CO 




CO 


V 




V 



13 

CO 



A 
CD 



CL 
V 



e 

CO *- 

i u - 



to 

CO 



to 
to 

CD 

■a 
■a 
< 



CD 

c 
o 

Q_ 



n^^Q^oiHHnmiiinHiiiH 



On 



O 

I— I 



. I: 



WEB^RED INSTRUCTION 
ERU^MjNUM 

09/7287073 



hi 



■ w 



VP 



OS 



o 

On 



X 



_03 



pa 



CD 

an 

CO 



Oi 



TO 

El 

o 
o 

GO 



LUI 

CD 



o 

CO 
GO, 



co 
o 

ft 

Q-i 
CD 
31 



CD 



CD 

CD 
> 

o 



X 

o 

I 

E 
g 

I 

CD 

~o 

■o 
cz 

TO 



CO 
CD 
Q_ 

>^ 
Q_ 
O 
O 



O 
O 



CD 

E 

T3 
LU 



00 
"O 

cz 

JS 

"co 

CO 
CO 
CD 

■o 
■> 
o 

I— • 

Q_ 
_CD 
Q_ 

E 

03 
X 
CD 
CO 



E 

CD 



cz 

CD 



CD ^ 



J .22 
o * if 



CD 
O 
13 
"O 

o 



CO 
CD 



CD 

E 

"O 

cz 

CO 
CO 
ZJ 

c 

CD 

E 

CD 



CO 
CD 

O O 
k_ CZ 
CD 13 

co 

Z3 T3 

i? 8 

CD 1= 
-CZ o 

5 cz 

CD ^ 
T3 — 
O ZJ 
O -Q 



CO cz 
O CD 

m e 
s- ^ 

CO 

cz ^ 

? ^ 

-E CD 

2 & 

O JD 
*S CD 

§ 8 

CD 



cz E 
cd a> 

CD 3 

zj ^ 
-3 CD 

* E 

C35 
CZ CZ 
CD ^ 

.cz -Q 

5 s 
-g 55 

81 



o 



< 

CD 



o 

"O 



CD 
CD 



CO 
CD 
O 



CO 

E 
E 

Z3 
CO 

^ oj vw CD 



03 

O co 



CO 5=3 
O r- 



co 

CD 

3 

">< 
03 

CZ 

o 

to 
cz 
o 
E 

CD 

■o 

CD 



CZ 
CO 



CD 
CZ 
CO 



5 z □ c = z = 



5 - 



CO 
CD 

u. 



o o 

CD CD 
X X 



a LULU 



TZ* CD 
LL. CO 



O -Q 
CD CO 
X cz 
LU LU 



CD 
O 

ZJ 

o 

CO 



C «3 CZ > CZ 

£ o o 5 > 
«— — t — «^ 

"O *= CO "O m 
« (O O « „ 

0 jj gei| 

CO co '> 
!"tS CD ° 

-S £ Ql 



On 



JD 

E 

CO 
X 
LU 

CO 



CD 



_CD 

E 

CO 
X 
LU 



CD 

LU 

CD 



.92 
E 

CO 
X 
LU 



CD 



LU 

CD 



CD 

CD 
> 

o 



co 
E 
E 

ZJ 

cz t5 

— o 

=? "co 
< o 



E 1 

I 5 

"O LU 

CO ^ 

X 



3 

CO 



CD 



CL 
CO 



CD 
> 
LU 



O 



5 — ^ Q) ^ ^ 

T: M M 1 o « 
CD S o « ™ H 
O ™ « ^ _ 

^ == — 2 ^ o 

III 5^ 

S S 3 8 a-s 



□ CDI3CDEILI1LI1Q] 



CD 

E 



co 

cz 
o 
co 
cz 

-S2 
>< 



I .i 

C Q3 CO 

CO H a3 « 

~ CD CO X3 

O w <u o 
« f 

Jj " It ft 
"X c c c: 

^ 1 I I 

C XJ T3 

*=r a> a> a> 

|mmm 

E 



d 

tin 




BASED INSTRUCTION 

ENNUM 
8,073 



N 



>< 
O 



_cd 

OL 

E 

CO 
X 



CO 



CO 

o 
Oi 



CO 

El 

o 
o 

CQ 



LUi 

CD 



O 
CO 
CO, 



CO 

o 
|2 

Q_ 

CD 



< 
CD 



•H 
IS 



0) 

& c 

W CO 

a z a* 

-H O 

3 II • 

-p g 

T3 S 4J 
0) 



W 2 

PQ -P 
< -H 
2 h 13 
H ct; QJ 

s > 



CO 



Z Z 
PS hH 



£3 W 
U Pi Q 

z 



CD 



n 

*£ 

CO c= 
> CD 
CO o- 

CO 
CD 

I* 
11 
ii 

*i 

■a > 

« 

Ms 

S CO 

~ CD 

"O C- 

CD O 

S o 

ffl 

CO _fl 
CD ^ 

c: cd 
o 

_ CO 

c ° 

O CD 



Q- 

E 

CO 
X 
CD 

o> 

I 

CD 



CD 

a_ 
o 



5 

CO 



CD 



CD 

E 

CD 

o. 

CD 



c 

CO 
Oi 

o 



(S o o 



8 



o 

O. CD 

Q-o 

co c 

CD £j> 

CO CD 
CD *- 
M CO 

~C0 CD 

: — Q 
JElo 



T3 

CO 

w 

z 



CD CD 

o 
o 

CO ^ 

M 8 

~ ^ .9 

lis. 
cT^J 

■85 g 

o- 

5^ o 

^ m- CD 
^ O 00 
CD CD C 

« 

^ CD 

o_g 
giS a, 

£ O CD 
CD O CO 

* — o 
CO cz co 

CD 

CD CD _ 

ffl 

CD CD ^ 



CO 



CD ^— Z Z 

^1 D < 
^ 2 ^ W 

h u p 



CD 



CO 
CD 



CD 

£6 £ 



CD 
CD CJ 



X 

□ 



5 

o 



"O 
LU 



LUI 
_CD 











X 


o 


o 


-4— • 


CD 






LU 


a 

CD 

_c 


tart 


O 


CO 


n 





X 

■8 = g 

o o c: 

_ .ti CO 

o cd g 

& CO^ 
CO CO CD c 

Q CO CD 

E 

O cD.-^£ 
3 CD O 

"O CD CO 
CD <= CD CO 
CD "S CO "O 

<u£ cz » 



o 
o 

ON 



a 
a 





CD 




Q_ 




E 




CO 




X 

uu 




=3 




c: 


CD 


CD 






E 




CO 




X 


LU 


LU 


CD 


>■» 




_Q 




CO 




LU 


CO 




CD 


CD 






"co 




CD 




LL_ 


Fl 





_CD 

E 

CO 
X 

LU 

c: 

CD 



LU 

CD 



CD 

CD 
> 

o 



co 
£ 

c E 

O =3 
-g CO 

v2 CD 

. — . 1q 



CO 

-a 

_ CO 

co 



CO 

E 



o 



*2 »2 



_CD 
X3 



CD 
> 





CO 




CZ 


< 


o 


z: 


CO 




'sz 




n 




CL 




o 


CD 


CO 


CD 


CL 


_cz 
1 — 


o 


Ev 


E 



B I 1 « I 

h— XJ — 

= ^ *- ^ Q. CO 



2 > 

CO 

co : : 

H 1_ : ^ s 



-O"DOX3QC0CD 
(D0>C=(UOOa.-O 

□ □□□□DOG] □ 



CD 

E 
E 

CO 
cz 
o 

CO 



CO 3 a3 

I - 5 

CO _ ^ 
a. 



0) 

:: 

"X c c c 
LU § | | 

"r- IJ T3 T3 
J= a> <D <D 

as a 

x s= 



On 

d 
E 



WEB- 
ERIK 
09/728J 



m 

8^73 



D INSTRUCTION 
UM 



re 

Best 
Iff 




wemased instruction 
ef^Bennum 

09/7^,073 



m 
m 
a 



JD 
Cl 

E 
S 

LU 

>» 
-Q 

CO 



CD 



CD 
HIl 

GO 



Ol 



^=1 



Oil 



o 

CO 



CL 
O 



CO 
Z3 

o 
*2 



CD 



-9- CM 
CD — 
XI 



CD 



o 

T3 



0) 



c: 

-H 
3 



pa 

CO 



<D 
I — I 
XJ 

(0 

w 

CO 

£ 
a) 



T3 

PCI 

-p 

QJ 
10 

cs 



& 

CD 

a5 

CO 



CO 

E 

CD 



CD 

E 



-a , 
<D 



-S>g 

CD 
O i- 

§2 

"t3 ° 
c c 
3 o 
„ 'to 

CO 

s 3 

■a o 
CD <2 
5xi 

CO CD 

a> ctj 

^ CD 
= <D 

Sco 

CO O 

<d -a 

_co G> 
15 a> 



□ 



o. 
E 

CO 
X 
LU 

>* 
-Q 

CO 



5 
CD 



CL 

E 

CO 
X 



"a 
LU 
CD 

*o 

CO 

CO 
CD 




_CD 

E 

CO 
X 
LU 



CD 



CO 

E 



o 



LU 

CD 



CO 

E 
E 



c/> 
_CD 

■o 
cz 

CO 

in 



<B .22 S 

i « I 8 « n 

llilil 

O X 3 Q ca a> 
«- tt> O O Q. "D 



§5 < -£2 



o 

CD 

& 

CD 
> 

o 



o 

CD 

o 

~C0 

o 



CO ~ a o 



_CD 

cz 

CO 



CD 



CL CZ 
CO CD 

O LU 



CD 
> 



O 
CL 

E 



CD 



1 .1 

C 5) CQ 

i ? I 

c= r* >< 

X= X -D 5^ 

~ CD tTJ "O 

a s f -g 

S 7^ » ^ 



e s r; rr rt 

r7? "X ^ c c 
^ 1 | I 



□ □□□□□□CD 



o 

CO 

cz 

CD 
X 



"S "S "§ 

| ramm 

a. 
E 



O 

ON 

a 



webaased instruction 
eri^Bnnum 

09/72S!d73 



□ 



JD 

E 

LU 

LU 

CD 



_CL 
CD 

nil 

CO 

cz 
o 

Oi 

CO 



LUI 
CD 



o 

CO 
CD, 



0 

O 



JE 

CO 

Z3 
o 
o 

CD 

O 



^ "O 
Q - CD 
CD 



















»-3 






W 






CO 












tT 






CD 






i — 1 






XX 






rD 






c 




O 


W 




T3 


CO 




C 


B 




-H 


CD 




& 


-P 






»— 1 




CD 


-P 




CP 


-H 






T3 




tl 


W 






-P 






0) 




-H 


CO 










s 


a 




■H 


-H 










CD 




CQ 






*C 






M 


-H 

















CD 




-Q 




03 




CO 




■u 




o 
















"CD 




E 








CD 




CL 




LU 




CO 




1 




FA 




CD 




_£Z 








CO 




CD 




CO 




CO 




CD 
CL 


ox. 


Z3 


-D 






o 




CD 


CZ 


-5 


cusi 


the 












CO 


CQ 






CD 




CO 

ZJ 




CD 


CD 


CD 






_CD 


CO r- 


CD 




way 


ems 


CD 




E 


3 


CD 


£Z 


CO 


CD 


CD E 




o> 










CO "O 






CD 


1 





CO 
<D 



CD 
CO 



CO 

E 

CD 



cz 

CD 

E 



■o 

CD 

CD - 
£ § 

_Q 

CD 
CO 

^ o 

O CO 

o c 



o 

CD 



i_ O CD 
CZ ■*= 
—j CO 
^ CO 



-a £ 
u e 

_Q CO 

CD O 

CZ i_ 

LU CD 

co co 

E 3 
^ I — 
H g 

CD _Q 

CD O 
£ CD 



co o 
m 0) 



X 




Id 
1 '1 








O 




"O 




CZ 












LU 


LUI 




_CD 




u=i 



: x 
: o 
■co: 

o 
, cd; 

13 



X 

£ = g 

CD CO"" 
CZ t-~0 

oo c 

_~ CD 

E~o ^ 

p CD O 
CO CD 

CO CD CD p 
co£ §5 

«J On CD 

o S> 

.9 CD~£ 

*s u: cz_a 

CDiz 03. CO 
CD O 

co£ C CO 
30g0 



_CD 
CL 

E 

CO 
X 



LU 

CD 



_CD 

E 

CO 
X 
LU 



CD 



X3 
LU 

CD 



CL 

E 

CO 
X 



CD 



"O 
LU 
CD 



O 
§ 
CD 
& 
CD 
> 

o 



co 



■R CO 



o 

CD 

IcT 
O 

"co 
o 



CO 

E 



CO 

_<D 
~o 

CZ 
CO 



CO ~ 



w w " S 0) TO ^ ^ 

•s £ ~ "S --h S « » 



< 

CD 



JD 

c 

CO 



CD 
> 



CO 

CQ .-^ 

1— X3 



CL 
CO 

O uj — 



CO 

o 

CL 



riS ^ Q. co -Si 

"oxJOX3c?caa> 

03<UCZCX>OOQ_"O 

□ HEHEILT]!!]!!] 



CD 

E 



CO 

CZ 
O 
"co 



£ .2 

§ « S 
w g 

c ri x 

g 0) co -g 



to 



V) J: x 
^ cu a> 

O CL O. 



CD 

~>< c c c 

m i i i 



-2 



o 
E 



On 

a 



WEB^SED INSTRUCTION 
ERiWBnNUM 

09/728,073 




O 



WEMASED INSTRUCTION ^ 



J 



FUNCTION driveStockRpt( destType SMALLINT, destName CHAR ( * ) ) 
1200 RETURNING VOID 
^{.normal 

Since objects, in particular ixRow objects, cannot be passed 
as arguments to the report formatter, rows of fetched data will 
be unpacked into a record that matches the data types and lengths 
of elements in the fetched rows. 
} 

VARIABLE 

stockRec RECORD 

mn CHAR(15), — manuf act.manu_name 
sn SMALLINT, — stock. stockjium 
sd CHAR(15), — stock. description 
sp MONEY (6,2), — stock. unit_pr ice 
su CHAR(4) — stock. unit 

END RECORD 



stockStmt ixSQLStmt, 
stmtString CHAR(*), 
stockRow ixRow, 



error Code INTEGER, 
logFile ixErrorLog 

1205 
^{ .normal 

Use the implicit connection object to create an SQL statement 
object. The connection object must already be connected to a 
database. 

Checking the status of the prepare ( ) call will confirm this. 

1210 > 
^{ . [edit stmt} 

LET stockStmt = 

ixSQLConnect: :getImplicitConnection( ) .createStmtObject ( ) 
yr{ . ]f ile stmt} 
1215 
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1500 

Generating a Report Using the Web 
Datablade Module 

The customer report example demonstrates how to use the 
Web DataBlade module to query for data and report the 
results in HTML format 1505 

Contributed by cust db.html 1510 

ErikHennum, — 1505 

byExample Team ^ 

This app page accepts a query and generates an HTML report 

querydb.html — 1510 

1510 -< l J? 5 
This HTML page contains a form that invokes an app page 

sports Footer.tag — 1510 l5Q5 



The sportsFooter dynamic tag generates the footer for an 
app page. 

sportsHeader.tag — 1510 1505 



The sportsHeader dynamic tag generates the header for an 
app page. 

Click here to view or print all of the source files for this example. 
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1525 



querydb.html File 



This HTML page contains a form that invokes an app page instead of a CGI 
program to process the values in the form. 



The sportsHeader dynamic tag creates a standard header for the HTML page 
as well as standard opening text. 




<? sr>nrt^Header title= "Customer Query"> ^- 1530 

1540 

As its action, the form must specify the Web Driver utility. 



<FORM ACTION = " < ? MI VAR > $WEB_HOME< ? / MI VAR " METHOD= "GET" > 




1550 

To specify the app page, the form must use a hidden input component. The / 
input component must have a name of Mlval and a value that's the name of M535 
the app page. The input component below specifies the cust_db.html app ) 
page. 



< INPUT TYPE= "HIDDEN" NAME= " Mlval " VALUE= ° /examples /CustRpt /cust_db . html ■ > 



Optional state: 

< INPUT TYPE= "TEXT" NAME= " Selects tate " SIZE="3" MAXLENGTH= " 2 ' 
< INPUT TYPE =" SUBMIT" NAME = " SUBMIT" VALUE= " SUBMIT" > 

</FORM> 
</P> 



> 1530 



</BODY> 
</HTML> 
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querydb.html 

<!--<ibyx> ~~ 
<intro> 

<pxabstract>This HTML page contains a form that invokes 
an app page</abstract> instead of a CGI program to process 
the values in the form. 
</p> 

</intro> 
</ibyx> > 

<!-- <ibyx> 

<p> The sport sHeader dynamic tag creates a standard header ^ 1535 
for the HTML page as well as standard opening text. \ 
</p> } 
</ibyx> --> 

<? sport sHeader title=" Customer Query" > 
<!-- <ibyx> 

<p> As its action, the form must specify the Web Driver utility. 
</p> 

</ibyx>--> 
<P> 

<F0RM ACTION= ,, <?MIVAR>$WEB_HOME<?/MIVAR> u METH0D= " GET " > 
<!-- <ibyx> 

<p> To specify the app page, the form must use a hidden input component. 
The input component must have a name of <strong>MIval</strong> and 
a value that's the name of the app page. The input component below 
specifies the <a href="cust_db.html">cust_db.html</a> app page. 
</p> 

</ibyx> --> 

<INPUT TYPE=" HIDDEN" NAME="MIval" VALUE= M /examples/CustRpt/cust_db.html"> 
Optional state: 

<INPUT TYPE=" TEXT " NAME="selectState" SIZE="3" MAXLENGTH= " 2 " > 
<INPUT TYPE=" SUBMIT" NAME=" Submit" VALUE=" Submit" > • 

</F0RM> 
</P> 

<?annotate> 

</B0DY> 
</HTML> 
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<! - - <ibyx> 
<intro> 

<p> <abstract>This app page accepts a query and generates an HTML 
report< /abstract > in response. 

The app page uses dynamic tags to generate the header and footer for the 

HTML report. 

</p> 

</intro> 

</ ibyx> - - > 

<! - - <ibyx> 

<p> The sportsHeader dynamic tag creates a standard header 

for the HTML page as well as standard opening text. 

</p> 

</ibyx> - -> 

<?sportsHeader title= "Customer Report "> 
<! - - <ibyx> 

<p> First, the app page checks whether a state was specified to use for 
selecting customers in the state. If so, the block generates a 
paragraph to identify the state. 
</p> 

</ibyx> - - > 

<?MIVAR NAME-$WHERE_STRx?/MIVAR> 

<?MIBLOCK C0ND="$ {AND, $ (XST, $selectState) , $ {<,0,$ (STRLEN, $selectState) ) ) "> 
<?MIVAR NAME= $WHERE_STR> WHERE state= a $selectState" <?/MIVAR> 
<?MIVAR><P>For state: $selectState</P><?/MIVAR> 

<?/MIBLOCK> 

<! - - <ibyx> 

<p>Next, the app page starts the table that will contain the data. 
</p> 

</ibyx> - -> 

<P><TABLE BORDER="l"> 
<TR> 

<TH>Number</TH><TH>Name</TH><TH>Company</TH><TH>State</TH> 
</TR> 

<! - - <ibyx> 

<p> The MISQL block queries for customers, optionally selecting only customers 
from the specified state. Because the contents of the block are generated 
for every row of data, a new table row describes each customer. 

The &amp ;nbsp; HTML entity is a non-breaking space. By putting a non-breaking 
space in each column, we force the Web Browser to display the column even 
if the value is null. 
</p> 

</ibyx> - -> 

<?MISQL SQL= "SELECT customer_num, fname, lname, company, state FROM customer $WHERE_STR; "> 
<TR> 

<TD> $l  </TD><TD>$2&nbsp ; $3</TD><TD>$4&NbSP ; </TD><TD>$5  </TD> 
</TR> 

<?/MISQL> 

</TABLEx/P> 
< ! - - <ibyx> 

<p> The sportsFooter dynamic tag creates a standard footer 

for the HTML page. 

</p> 

</ibyx> - -> 
<?sportsFooter> 
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1900 



Creating Web Applications with the Web 
Data Blade AppPage 

^1930 

In this How To we'll build a simple Web application using Web DataBlade Application Page (AppPage). This 
Web application will access an Informix database. 

Requirements: IDS 9.x, the Web DataBlade module, BladeManager, and a web server. BladeManager is 
provided with IDS 9.x for UNIX. NT users must install BladeManager from the DataBlade Development Kit 
(DBDK) 



These instructions assume you've already installed Informix IDS 9.x and have it running locally. 



4935 



Define a server connection and prepare a sample database, j 
1 . Define a server connection with setnet32 (NT). Create a sample database > Prepare Database, 
or use the stores7 demo database. 



2. 



Prepare the Web DataBlade development environment. 
Install the Web DataBlade module and BladeManager. 



Prepare Web 
DataBlade 
Development 
Environment. 



3. 



Register the Web DataBlade module in the demo database with 
BladeManager. 



4. Create a sbspace for smart large objects, like gifs. 

5. Install AppPage Builder in your database. 



Register the Web 
> DataBlade. 



Create Smart Blob 
^ Space (sbspace). 



Install AppPage 
^ Builder in Your 
Database. 



6. Setup AppPage Builder on your web server. 



Setup AppPage 
^ Builder on Your 
Web Server. 



7. Create a sample AppPage. 



Create Sample 
t> AppPage. 



8. 



Run the sample application. 
EntertheURL http:// your_s erver /scripts / webdr i ver . exe . 

This How To has been compiled into two separate files for ease of printing. The basic file contains all of the steps 
you need to Create Web Applications with AppPage Builder. The secondary file contains additional detailed 
instructions for setting and testing database environment properties. 
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